VAXELN Version 2.2 



Realtime Software Toolkit for Dedicated VAX and Micro VAX 
Applications 




Features 

Full VAXELN Toolkit that runs on a VMS or Micro VMS host to produce tight 
execution code on a dedicated system. 

Includes an extended ISO Pascal compiler (EPascal) that is optimized for 
realtime code. Runtime libraries are also included for EPascal, C, and 
FORTRAN-77. 

Supports an Ada compiler and Ada runtime libraries, a C compiler, a FORTRAN 
compiler, and Rdb/ELN Relational Database Software. (All of these are options 
for the VAXELN Toolkit.) 

Provides a simple, small kernel to control sharing of the system's resources on the 
dedicated system. 

Supports local debugging on the target system's console terminal and remote 
debugging over an Ethernet from a user terminal on a VAX/VMS system. 

Includes a powerful system builder that combines program images, the kernel 
image, and runtime routines into a finished VAXELN system image. 

Supports multitasking and multiprogramming from the VAXELN kernel, the 
EPascal compiler, the C runtime library, and Ada? 

Offers device drivers for a range of Q-bus and UNIBUS devices including disks 
for file storage. 

Provides transparent network communications among VAXELN and VMS nodes 
via Ethernet-based DECnet (DAP). 



Description 

VAXELN Version 2.2 adds support 
for the VAX FORTRAN-77 runtime 
library to Digital's realtime software 
development toolkit. The VAXELN 
Toolkit runs on a VAX or Micro VAX 
system to generate tight execution 
code for a dedicated realtime proces- 
sor. On the dedicated system, the 
VAXELN kernel controls the use of 
shared system resources. 

As a VMS layered product, the VAX- 
ELN Toolkit gives you access to the 
rich software development resources 
of the VMS environment. The Toolkit 
itself provides optimized tools to help 
you create an execute-only applica- 
tion that runs under the VAXELN ker- 
nel on the dedicated system. VAXELN 
applications work in situations - such 
as factory automation, dedicated 
CAD/CAM workstations, and large- 
scale data collection/reduction 
systems -in which individual proces- 
sors have dedicated or predetermined 
functions. These applications can be 
either stand-alone units or part of an 
Ethernet Local Area Network (LAN) 
with VAX/VMS nodes or any other 
node using DECnet service and 
protocols. 



The VAXELN Toolkit Helps You 
Generate Efficient Runtime 
Applications 

The VAXELN Toolkit gives you the 
development resources you need 
to write efficient realtime code. It 
includes the extended EPascal com- 
piler, libraries with the VAXELN ker- 
nel and system services, a system 
build utility, and a symbolic debug- 
ger. An extended VAX C runtime 
library and VAX FORTRAN-77 rou- 
tines ship with the VAXELN kit. You 
also have the option of ordering 
Toolkit options such as the VAXELN 
File Service, Network Service, high- 
performance device drivers, extended 
VAX Ada runtime routines, template 
device drivers, the Rdb/ELN rela- 
tional database, and compilers for 
VAX C and FORTRAN. 

With VAXELN, you work in the 
familiar VAX/VMS development envi- 
ronment to create your realtime appli- 
cation. (Figure 1 shows the general 
elements in the application develop- 
ment cycle.) Use VMS language- 
sensitive editors to help you create 
the source code. Write your applica- 
tion in the Toolkit's EPascal, with calls 
to VAX C, VAX FORTRAN-77, and, 
optionally, VAX Adaf Link the com- 
piled code to the VAXELN Toolkit 
runtime library using the standard 
VAX/VMS linker. For easier debug- 
ging either locally or remotely across 
an Ethernet LAN, use the VAXELN 
debugger. The VAXELN debugger 
is based on the VAX debugger and 
lets you debug both modules and 
entire applications. When you're 
ready, combine the necessary images 
with the VAXELN system builder to 
create an efficient, low-overhead run- 
time application. 
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Figure 1 : VAXELN Application Development Elements 



EPascal Provides an Extended ISO 
Pascal Compiler 

EPascal is a highly optimized native 
mode Pascal compiler that builds on 
the ISO standard to provide realtime 
extensions. These extensions let you 
work in the flexible Pascal language - 
instead of assembly language -to write 
even device drivers and other perfor- 
mance-critical parts of your code. The 
EPascal program also lets you include 
routines written in VAX C, FORTRAN, 
and MACRO-11. 

The EPascal runtime library features 
support for special I/O operations, 
standard Pascal routines such as SIN, 
and certain procedures used in sys- 
tem programming. This support is 
provided in both object-library and 
shareable-image forms. 



Powerful language extensions simplify 
and speed application development. 
For example, you can use a generalized 
mechanism, flexible types, to declare 
data with parametric extents. You 
can predeclare fixed-length strings, 
varying length strings, and a series of 
uninterpreted data types. And you 
can declare procedure and function 
parameters with conformant extents. 

Another EPascal compiler feature 
effectively extends Pascal-type check- 
ing to separately compiled modules 
to let you create and compile source 
code in separate modules. As each 
module is compiled, declarations or 
cross-references involving it and the 



modules already in the program 
library are automatically checked for 
consistency. In addition, full data-type 
checking is maintained on the prede- 
clared kernel data types DEVICE, 
EVENT, MESSAGE, NAME, PORT, 
PROCESS, and SEMAPHORE. 

VAXELN Kernel Controls Tight 
Execution Code 

The VAXELN kernel supports both 
multitasking and multiprogramming. 
Its multitasking capability lets you 
declare parts of a program to be 
scheduled for concurrent execution 
with the main program. Its multipro- 
gramming feature enables you to 
schedule entire programs, including 
multitasking programs, for concurrent 
execution on the same CPU. 

The kernel uses VAX memory man- 
agement to map user processes in the 
P0 and PI regions of a 4-Gbyte virtual 
address space. The user stack is inde- 
pendently mapped into the PI (con- 
trol) region for each process in the 
system. A VAXELN process running 
on a single processor can be as large 
as the amount of physical memory on 
that dedicated processor. 

In general, VAXELN systems are inde- 
pendent jobs that exchange informa- 
tion by message transmissions. Jobs 
can be created dynamically to execute 
a specific program included with the 
system builder. 




Figure 2 . VAXELN Application Components 



Jobs running on the same processor 
are scheduled on a preemptive prior- 
ity basis. Jobs can be assigned up to 32 
priority levels. Within a job, 16 inde- 
pendent priority levels are available 
for preemptive process scheduling. 
You can stop then resume process 
rescheduling within a job. 



Broad System Builder Combines 
Images 

The VAXELN system builder does the 
majority of the application build work 
for you. It combines program images, 
the VAXELN kernel image, and run- 
time routines into one image of the fin- 
ished VAXELN system. The resulting 
image keeps overhead to a minimum 
by including only those images neces- 
sary for that particular application. 

The system builder accepts program 
images from a variety of sources, in- 
cluding programs written in EPascal, 
subprograms written in other VAX 
languages such as Adaf FORTRAN-77, 



C, and MACRO- 11. It also collects the 
necessary images from the VAXELN 
kernel itself and from the VAXELN 
Toolkit. Figure 2 illustrates the possi- 
ble components in a VAXELN appli- 
cation and includes the minimum 
memory requirements for each. 

VAXELN Debugger for Remote Or 
Local Interactive Debugging 

You can use the VAXELN Debugger 
for interactive debugging either 
locally at the target system's console 
or remotely over an Ethernet connec- 
tion. Either way, you can evaluate 
expressions in a Pascal-like syntax, 
execute VAX/VMS-like debugger com- 
mands, and debug kernel-mode code. 
You can also define new debugger 
commands and variables as necessary. 

If you have the optional DECnet-VAX 
license and Ethernet hardware, you 
can debug the application from a ter- 
minal on another VAX/VMS node. 
This remote debugger supports sym- 
bolic debugging -that is, manipulat- 
ing variables and other items by their 
declared names. It can also display the 
status of all VAXELN processes and 
jobs in the LAN. 

VAX C and FORTRAN-77 Runtime 
Libraries Arrive With the Kit 

The VAXELN product ships with an 
extended VAX C library and a library 
of VAX FORTRAN-77 routines. An 
extended VAX Ada® runtime library 
is also available as an option. These 
libraries let you include existing rou- 
tines in your VAXELN application and 
give you the choice of development 
languages. 



Extended VAX C Runtime Library. 
VAXELN supports the VAX C language 
with an extended C runtime library. 
The library contains over 130 routines 
that implement the standard VAX C 
runtime environment. Realtime exten- 
sions to the standard library let you 
work in this high-level language to 
write performance-critical code such 
as device drivers. The VAXELN debug- 
ger fully supports the VAX C language 
and the runtime library. 

VAX FORTRAN-77 Runtime Library. 
The VAX FORTRAN-77 runtime 
library lets you include standard 
FORTRAN-77 modules in your appli- 
cation system image. The VAXELN 
debugger supports both these mod- 
ules and the runtime library. 

VAXELN Options Tailor the 
Environment to Your Needs 

The optional software available for 
the VAXELN Toolkit lets you select 
exactly the components you need. 
In addition to the optional VAX Ada 
runtime routines, choose from the 
VAXELN File Service, the VAXELN 
Network Service, and the Rdb/ELN 
relational database software. 

VAXELN also gives you a choice of 
the following devices that are sup- 
ported on the dedicated realtime 
processor. 



■ RQDX1, RQDX2, or RQDX3 disk con- 
troller with the following drives as 
appropriate to meet hardware config- 
uration requirements: RX50 (2 by 400 
Kbytes) diskette drive; RD51 (11 Mby- 
tes), RD52 (31 Mbytes), or RD53 (71 
Mbytes) Winchester disk drive. VAX- 
ELN supports up to four of either 
type of drive. 

■ KDA50 Q-bus disk adapter for up to 
4 Digital Storage Architecture (DSA) 
disks: RA80, RA81, or RA60. 

■ RQC25 52 -Mbyte fixed/removable 
disk subsystem and RC25 add-on 
drives. 

■ DEQNA Ethernet-to-Q22 adapter 

■ DZV11 or the DZQ11 4-line asynchro- 
nous multiplexer 

■ DHV11 8-line asynchronous 
multiplexer 

■ Console terminal 

■ LPV11 lineprinter controller 

■ DLV11 asynchronous serial controller 

■ DRV11 parallel line interface 

■ ADV11-C, AXV11-C, and KWV11-C 
realtime devices 

■ TK50 streaming tape 

■ DMF-32 multifunction board (LP32 
lineprinter and asynchronous line 
support) 

■ RA80/RL02 combined disk drives 
(VAX-11/730) or dual RL02 disk 
drives 

■ UDA50 UNIBUS Disk Adapter and up 
to 4 DSA disks: RA80, RA81, RA60 

■ RUC25 52 -Mbyte fixed/removable 
disk subsystem and RC25 add-on 
disk drives 

■ TU81 UNIBUS tape drive 

■ DEUNA UNIBUS-to-Ethernet adapter 

■ TU58 cartridge tape 



VAXELN Ada Routines Add Ada to 
Your Language Choices 

The optional VAXELN Ada® routines 
enable you to include Ada modules in 
your application. If you have VAX 
Ada -recognized as among the best 
Ada compilers -you can also write 
your realtime application in Ada. The 
VAX Ada compiler lets you defer the 
choice of target system until you link 
the application, so you can easily 
build applications that run under 
either VAXELN or VMS. VAXELN 
Ada also uses the VAX Ada program 
library to make it easier to develop 
applications for both systems. The 
VAXELN Ada routines are fully inte- 
grated into the VAXELN execution 
environment, giving you access to sys- 
tem services, device utility routines, 
and distributed application features. 

Optional Services for a Variety of 
Realtime Applications 

VAXELN File Service. If your applica- 
tion includes disks, you can include the 
VAXELN File Service to provide the 
file support you need. The VAXELN 
File Service supports I/O operations 
from EPascal programs to file-storage 
devices, such as disks, and from other 
DECnet nodes (with Network Service). 
The VAXELN File Service uses the 
VAX/VMS on-disk structure (ODS-2) 
internal file format. 



VAXELN Network Service. When you 
develop a distributed realtime appli- 
cation, choose the optional VAXELN 
Network Service. These services pro- 
vide transparent network communi- 
cation between VAXELN nodes in a 
LAN and between VAXELN nodes 
and VAX/VMS nodes. With Network 
Services, you can downline load appli- 
cations across an Ethernet network. 

Optional Rdb/ELN Provides 
Relational Database Support 

Rdb/ELN enables you to build your 
realtime application on a relational 
database. As a member of Digital's 
relational products family, Rdb/ELN 
supports the Digital Standard Rela- 
tional Interface (DRSI). This support 
means that applications you devel- 
oped with other DRSI-based products 
will run under Rdb/ELN, and applica- 
tions you create with Rdb/ELN will 
run under other DRSI products. 

Rdb/ELN provides full relational 
database functionality with excellent 
performance. It also assures data 
integrity. Rdb/ELN simplifies appli- 
cation development and increases 
application flexibility by combining 
the relational data model with remote 
database access and the capability for 
handling application-defined datatypes. 



Digital Means Service 

The sophisticated work that goes 
into developing realtime applications 
requires equally sophisticated support 
and service. Digital has the worldwide 
resources required to provide this 
level of support. These resources take 
shape with trained hardware and soft- 
ware service representatives available 
worldwide 24 hours a day, 7 days a 
week and include a range of service 
offerings such as hardware and soft- 
ware installation, onsite consulting, 
and scheduled maintenance. 

Digital can help you develop your own 
resources through our extensive train- 
ing programs. Choose from options 
ranging from classroom courses avail- 
able in our 25 worldwide training 
facilities to audio/visual courses that 
you can take at your own site within 
your own schedule. 

Digital means service at every level, 
everywhere in the world. 



VAXELN Toolkit Requirements 

The host development system for the 
VAXELN Toolkit should have at least 
1 Mbyte of physical memory, 2 Mbytes 
of virtual page file quota per user, and 
a 250-page minimum working set per 
user. Digital recommends the follow- 
ing systems as host for the Toolkit. 

■ Micro VAX II 

■ VAX-11/730, 750, 780, 782, or 785 

■ VAX 8200, 8300, 8500, 8600, 8650, 
or 8800 

The target dedicated system that will 
run the VAXELN application should 
have at least 1 Mbyte of physical 
memory and a load device. Digital 
recommends the following processors 
as the realtime target system. 

■ Micro VAX II 

■ VAX-11/730 or 750 

Digital recommends the following 
load devices. 

■ Ethernet adapters for downline 
loading 

■ Files-11 disk, RX50, RA60, RC25, RL02 

■ TU58 cartridge tape 

■ TK50 for the MicroVAX II 

■ ROM (MRV11-D) 

Optional Software 

■ VAXC 



■ VAX FORTRAN 

■ VAX Rdb/ELN 

■ VAX Ada/ELN 



Ordering Information for Available VAXELN Products 



Order Number 


Description 


Q*375-UZ 


Single-user License for Development System 


Q-376-DZ 


Single-user License for Target System 


Q-387-90-DZ 


Multiple Copies of the Single-user License for 




Target Systems 


Q*375-H3,H5,HM 


Distribution and Documentation Options 


Q*375-HZ 


Software Revision Right to Copy Option for the 




Development System 


Q*376-HZ 


Software Revision Right to Copy Option for the 




Target System 


Q i 372-GZ 


Documentation Only Option 


Q*375-13,I5 


Installation Service Option 


0*375-93,95 


Digital Support Service Options 


Q*375-83,85 


Basic Service 


Q*375-33,35 


Self-Maintenance Service 


Q*375-E5 


Source License and Sources Distribution 



"The specific order number is determined by the system for which you are ordering the product. 



Digital believes the information in this publica- 
tion is accurate as of its publication date; such 
information is subject to change without notice. 
Digital is not responsible for any inadvertent 
errors. 

The following are trademarks of Digital Equip- 
ment Corporation: ALL-IN-1, CI, DEC, DECnet, 
DECUS, DIBOL, the Digital logo, MASSBUS, 
Micro VAX II, Micro VMS, Q-bus, ULTRIX, 
UNIBUS, Rdb/ELN, Rdb/VMS, VAX, VAXBI, 
VAXcluster, VAXELN, and VMS. 

Ada is a registered trademark of the U.S. 
Government. 



